### 功能描述

查询主机Agent在作业平台中的信息（可执行状态、版本等）

### 请求参数说明

#### Body参数

| 字段            | 类型         | 必选 | 描述                                                |
|---------------|------------|----|---------------------------------------------------|
| bk_scope_type | string     | 是  | 资源范围类型。可选值: biz - 业务，biz_set - 业务集                |
| bk_scope_id   | string     | 是  | 资源范围ID，与bk_scope_type对应, 表示业务ID或者业务集ID            |
| bk_biz_id     | long       | 是  | *已弃用*。业务ID。此字段已被弃用并由字段bk_scope_type+bk_scope_id替换 |
| host_id_list  | list<long> | 是  | 主机ID数组，单次查询主机数量不可超过5000                           |

### 请求参数示例

- POST

```json
{
    "bk_scope_type": "biz",
    "bk_scope_id": "1",
    "host_id_list": [
        1,
        2,
        3
    ]
}
```

### 返回结果示例

```json
{
    "result": true,
    "code": 0,
    "data": {
        "agent_info_list": [
            {
                "bk_host_id": 1,
                "status": 0,
                "version": "2.1.4"
            },
            {
                "bk_host_id": 2,
                "status": 1,
                "version": "2.1.5"
            },
            {
                "bk_host_id": 3,
                "status": 1,
                "version": "2.1.6"
            }
        ]
    },
    "job_request_id": "xxx"
}
```

### 返回结果说明

{% include '_generic_response.md.j2' %}

##### data

| 字段              | 类型           | 是否一定不为null | 描述                                                                      |
|-----------------|--------------|------------|-------------------------------------------------------------------------|
| agent_info_list | list<object> | 是          | 元素为Agent信息，详情见agent_info对象定义，若传入的host_id在返回结果的列表中不存在，则表示未查询到该主机的agent信息 |

##### agent_info

| 字段         | 类型     | 是否一定不为null | 描述                |
|------------|--------|------------|-------------------|
| bk_host_id | long   | 是          | 主机ID              |
| status     | int    | 是          | Agent状态：0-异常，1-正常 |
| version    | string | 是          | Agent的版本          |
